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Ap plirntionMediQtorlmDl.exitn : AUS8- 1999-0694 

A* 

♦ Exit the ApplicationMedictcr by exiting oil ollccc^sd V^wConirnilers _ . - -- 

♦ and ApplicationMediators. All data is set to null, and lists ore 

♦ destroyed. An 'exited' ApplicationMediotor cannot be used ogoin. 

♦ If this method is overriden in a subclass, be sure to invoke 

♦ super.exitQ; 
*V 

public void exit{) { 

synchronized (this) { 

/♦ Used for style 1 event dispatching. Leave this code connmented. »/ 
//if (this.eventThread !=null) | 
// try] 

// eventThreod.stop (); 
// j cotch (Exception e) { 

// I 
//I 

/* Used for style 2 event dispatching. Leave this code commented. »/ 
for (int i = 0: i < runningThreads.sizeQ; i++) \ 

((ApplicotionMediatorThreod) runningThreads.elementAt (i)) .stop(}; 

runningThreads.removeAIIEIementsQ; 
viewListeners.removeAIIEIementsO; 
try I 

for (int i = 0; i < viewControllers.sizeQ; i++) j 

((ViewController) viewControllers.elementAt(i)) .setEnab!ed(false); 
((ViewController) viewControllers.elementAt(i)) .exit (); 

for (int i = 0; i < opplicationMediotors.sizeQ; i++) | 

((ApplicotionMediator) applicotionMediators.elementAt(i)) .setEnabled(false); 
((ApplicationMediotor) applicotionMediators.elementAt(i)) .exit(); 

I catch (Exception noProblem) | 

viewControllers = null; 
opplicotionMediators = null; 
runningThreads = null; 
runningThreods = null; 
data = null; 

I 

^ FIG. 17F 
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ADplicationMediQtorlmpl.clenrQ : AUS8- 1999-0694 
/- 

^ Clear th: AppiicationMeuiator by clearing all allocated ViewContrullers 

* and ApplicotionMediators. All dato is set to null, but lists ore 

* not destroyed. A 'cleared' ApplicotionMediotor con be used again. 

* If this methed is overriden in o subclass, be sure to invoke 

* super.clearQ; 

V 

public void clearQ | 

synchronized (this) | 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//if (this.eventThread != null) | 
// try! 

// eventThreod.stop (); 

// I catch (Exception e) } 

//I 

/♦ Used for style 2 event dispatching. Leave this code commented. »/ 

for (int i = 0; i < runningThreads.size(); i++) | 

^ ((ApplicotionMediotorThread) runningThreods.elementAt (i)) .stopQ; 

runningThreads.removeAIIEIements(); 

// 
try j 

for (int i = 0; i < viewControllers.size(); i++) | 

(JViewController) viewControl!ers.elementAt(i)) .setEnabled(false); 
^ ((ViewController) viewControllers.elementAt(i)) .clear (); 

for (int i = 0; i < applicationMediators.size(); i++) | 

((ApplicationMediator) applicationMediotors.elementAt(i)) .setEnabled(folse); 
^ ((ApplicationMediator) applicotionMediators.elementAt(i)) xlearQ; 

I catch (Exception noReolProblem) | 

viewControllers = null; 
' opplicationMediolors = null; 
data = null; 
^ viewListeners.removeAIIEIements(); 

FIG. 1 7G 
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* Initolize the ApplicotionMediotor using the listeners of on 

♦ existing ApplicationMediotor. 

*/. . . 

public void init(ApplicGt!0.nMediotor opplicouonMediotor) | 

it (opplicQlionMediotor instanceof ApplicotionMediatorlnnpl) | 

ApplicotionMediotorlnnpl o = (ApplicctionMediotorlnnpl) opplicotionMediator; 
requestListeners = (Vector) a.requestListeners.clone(); 
pIccennentListeners = (Vector) a.placementListeners.clone(); 
topListeners = (Vector) o.topListeners.clone(); 
addViewListener(Q); 

initQ; 

^ FIG. 17H 
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* When new data arrives allow the ViewControllers 

* and ApplicationControllers to be refreshed also. 

V 

public void refresh(Object data) | 
this.dota = data; 
try I 

synchronized (viewControllers) | 

for (int j = 0; j < viewControllers.sizeO; j++) j 

((ViewController) viewControllers.elennentAt(j)). 
refresh(dato); 

( ^ 

catch (Exception noRealProblem) | 



try I 

synchronized (opplicotionMediators) | 

for (int j = 0; j < opplicationMediotors.sizeO; j++) \ 
((ApplicationMediotor) opplicationMediators. 
elemenlAt(j)).refresh(data); 

j ^ 

{ cotch (Exception noRealProblenn) | 



FIG. 171 
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* A ViewEvent is delivered. Process it using Threading style 1 or 2. In 

♦ the end, the processViewEvent will be called on the subclass. 

V 

public void viewEventPerformed (ViewEvent e) | 

/* Used for style 2 event dispatching,- start an inner class thread */ 
ApolicationMediatorThreGv t = ne»v AppiicctionMediotorThreod (e); 
runningThreods.addElennent (t); 
t.stort (); 

/* Used for style 1 event dispatching. Leave this code connmented, ♦/ 

//ViewEvent saved = saveViewEvent(e); 

//if (eventThreod == null | | leventThread.isAliveQ) | 

// finished = false; 

// eventThread = new Thread(this); 

// eventThread.stort (); 

//synchronized (this) j 
// notifyO; 

I " 

FIG. 17J 
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This nnethod is used in style 1 threading. Renonne this to run () 
* and unconnnnent the code as described in the class javodoc. 
/ 

public final void run2 () | 

/♦ Used for style 1 event dispatching. Leave this code comnnented. */ 
/» 

while (true) | 

ViewEvent event = null; 
event = getViewEvent (); 
if (event != null) | 

handleViewEvent (event); 
I else I 

waitForEvent (); 

if (finished) | 

// something went wrong with the thread so hose this loop 
break; 

. I 



I 



FIG. 17K 
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• Private class to handle executions of ViewEvents () on another thread. 
**/ 

pnvote closs ApplicationMediatorThreod extends Threod } 

/*♦ ^ ^ 

* The cu'Ti^nt cvVcra 

private ViewEvent event; 

A* 

* Create an ApplicationMediatorThread to process the ViewEvent 
**/ 

public ApplicationMediatorThreod(ViewEvent event) | 
super (); 

this.event = event; 

* Just call the hondleViewEvent method thot the subclass will override 

*v 

public void run () | 

^ processViewEvent (event); 

^ FIG. 17L 
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* Save the current ViewEvent on a Q 

y 

private final ViewEvent soveViewEvent (ViewEvent e) { 

/* Used for style 1 event dispatching. Leave this code commented. ♦/ 
//return viewEventQueue.add(e); 
return null; 

( 

/- 

♦ Method; return the first view event saved. Used by the Q*ing system. 
*/ 

private ViewEvent getViewEvent () j 

/* Used for style 1 event dispatching. Leave this code commented. */ 
//return (ViewEvent) viewEventQueue.remove(); 
return null; 

FIG. 17M 
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TronsDorter.reQuestEventPerformedfReQu?stEvent) :AUS8- 1 999-0693 

A* 

Submit a synchronous request. For each Destination that is listening for 
the current family of RequestEvents (the major code), send the RequestEvent 
to the Destination for processing. If there is a problem, throw 
0 RequestException. Continue processing the RequestEvent as long 
OS a RequestException is not thrown by a Destination and the RequestEvent 
is not consumfiH, 
<p> 

If tagging is enabled, then append o status tag to the RequestEvent. 
<p> 

Destinations ore processed in the following FIFO order: 

1- All using (priority). 

2- All using o major code. 

3- All using 
<P> 

^©exception RequestException if the Request con't be submitted 

public void requestEventPerformed(RequestEvent request) throws RequestException j 
if (lenobled) | 

^ throw new RequestException('*Transporter disabled"); 

/» Try to tog the request */ x 
if (tagging) ^2606 
request.setStatus(request.getStatus() + "[Transporter]"): 

/♦ Process PRIORITY, major and then WILDCARD destinations ♦/ 
processDestinationsfrequest. getDestinotionsfPRIORITY)); 
processDestinotionsfrequest, getDestinotions(request.getMajor())); 
processOestinations(request, getDestinations(WILDCARD)); 



FIG. 26 F 
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* Submit on asynchronous request. See the synchronous 

* requestEventPerformed for more informotion. 

V. 

public void requestEventPerformed(RequestEvent request, 
RequestResponseListener caller) throws RequestException | 
if (lenobled) \ 

^ throw new RequeslException("Transporter disabled"); 

if (tagging) 

request.setStatus(request.getStotus() + 

"[Transporter osync.]"); "^2608 

//start on inner class thread 

TronsporterThreod t = new TransporterThread(request. caller); 

runninqThreads.put(request, t); 

t.startQ; 

FIG. 26G 
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/ 

TronsDorter.TransDorterThreGd :AUS8- 1 999-0693 
/**. 

* PrivGie ci'j5S to handle executions of subrr'tsf) on. another 
thread. 

**/ 

private doss TronsporterThreod extends Thread | 

A* 

* The current request 

A* 

private RequestEvent request; 

A» 

* The caller of submit that we will coll back 

♦V 

private RequestResponseListener caller; 



* Create o transporter thread 
**/ 

public TransporterThread(RequestEvent request, 
RequestResponseListener caller) | 
superQ; 

this.request = request; 
this.coller = caller; 

* Just coll the synchronous version of 
requestEventPerformedO 

**/. 

public void run() | 
try I 

requestEventPerformed(request); 

caller.requestResponse(request); 
I catch (RequestException yikes); \ 

caller.requestException(yikes); 
j finally | 

runningThreods.remove(request); 



FIG. 26 H 
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package com.ibm.jtcx.seria'izatinn; 

import java.io.Externalizable; 
import java.io.IOException; 
import java.io.Objectlnput; 
import java.io.ObjectOutput; 
A* 

* Default type comment. 

* <P>INVARIANT: 

public doss BaseData implements Externoiizabie { 
private Object[] data = null; 

/*♦ 

* BaseData constructor comment. 

V 

public BoseDotaO | 
this(O); 

A* 

* BaseData constructor comment. 

* ©porom dotoArray java.lang.Obiect[] 
♦/ 

public BaseData{int count) | 
superQ; 

setData(new Object[count]); 

A* 

* Default method comment. 
« 

* <P>PRE: 

* <P>POST: 

* ©return Parameter not modified 

* ©return jovo.lonq.Objectf] 
*/ 

public final Object[], getDotoQ | 
return data; 

I 

FIG. 107 A 
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♦ Default method comment. 
* 

♦ <P>PRE: 

♦ <P>POST: 
♦ 

» ©return Parameter not modified 

* @return java.lang.Object 
» ©parom index int 

public finol Object getData(int index] } 
Object retVol = null; 

if ((doto != null) kk (index < data.length)) j 
retVol = data[index]; 

{ 

return retVal; 

I 

* Default method comment, 
* 

* <P>PRE: 

♦ <P>POST: 
* 

* ©return Porometer not modified 

* ©parom in Objectlnput 
♦/ 

public void reodExternal(ObjectInput in) 

throws ClossNotFoundExceplion. lOException | 

setOatQ((Object[])in.reodObject{)); 

I 

A* 

♦ Default method comment. 
* 

* <P>PRE: 

» <P>POST: 

* 

» ©return Porometer not modified 

♦ ©porom dotoArray jovo.lang.Object[] 
*/ 

public finol void setData(Object[] dotoArray) j 
doto = dotoArray; 

I 

FIG. 107B 
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A* 

♦ Default method comment. 

* <P>PRE: 
» <P>POST: 

* 

* ©return Parameter not modified 

* @param index int 

♦ @param datoEiement javo.lang.Object 
♦/ 

public final void setDotoOnt index, object datoEiement) | 
if ((doto != null) kk (index < dota.length)) \ 
dotofindex] = datoEiement; 

A* 

♦ Default method comment. 
♦ 

♦ <P>PRE: 

♦ <P>POST: 

* ©return Parameter not modified 

* ©porom out ObjectOutput 
V 

public void writeExternal(ObjectOutput out) throws lOException \ 
out.writeObject(getData()); 



FIG. 107C 
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package com.ibm.jtcx.berializQtion; 



ava.io.Externalizable; 

ovo.ioJOException; 

ava.io.Objectlnput; 

ava.io.ObjectOutput; 

lava. moth. BigDecimal; 

iova.math.Biglnteger; 

ava.util.Date; 

iova.util. Enumeration; 

ova.utiLGregorionCalendar; 

iova.util. Hashtable; 

lovo.util.SinnpleTimeZone; 

ova.util.TimeZone; 

ovo.util.Vector; 



innport 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 
import 

A* 

» Base class of date objects that require small serialization. The 

* attributes of the data object are stored in an array and the elements 

* of the array ore written individually. 
* 

* <P> INVARIANT: 

public class BoseDatoS extends BaseDoto implements Externalizoble } 

A* 

* Default constructor. 

V 

public BoseDotaSO j 
^ superQ; 

A* 

* Creates a new <code>BaseDataS</code> object with a data array of 

* size <code>count</code>. 
* 

* ©parom count the size of the data array contoining the attributes 
*/ 

public BaseDataS(int count) | 
super(count); 



FIG. 108A 



Reads the array of data elements from the stream. The responsibility 
of reading the individual element is left to the 
<code>BaseSerializer</code> via <code>readObject()<code>. 



©poram in the input stream that contains the serialized object 

* ©exception CiossNotFoundException thrown ir 

* <ccdc>BcGeS3riG!izer</code> foils tc reo^i Ine object from the stream, 
©exception lOException thrown if 

<code>BaseSerializer</code> foils to read the object from the stream 
©see BoseSeriolizerjifreadObject 

public void readExternal(Objectlnpul in) 

throws CiossNotFoundException. lOException | 



nt size = in.readShort(); 



if (size == -1) I 

setData(null); 

j else j 

Object[] array = new Object[size]; 

for (int i = 0; i < size; i++) { 

array[i] = BaseSerializer.getlnstance().readObject(in); 

setDQta(array); 

I 

♦ Writes the array of data elements. The responsibility of writing the 

♦ data elements is left to <code>BaseSerializer</code> via 

♦ <code>writeObject()</code>. 
* 

♦ ©porom out the output stream to which the data elements will be 

♦ written 
V 

public void writeExternol(ObjectOutput out) throws lOException | 
Object[] array = getDotoQ; 

if (array == null) | 

out.writeShort(-l); 

j else j 

out.writeShort(array.length); 

for (int i = 0; i < orray.length; i++) | 

BaseSeriali2er.getlnstance().write0bject(out. array[i]); 

' 10800 
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packoge com.ibm.jtcx.seriolizotion; 



impor 
impor 
impor 
impor 
imporl 
imporl 
imporl 
imporl 
imporl 
imporl 

/■ 



jova.io.*; 

java.moth.Biglntener; 
jova.math.BigOecimol; 



jovo.uti 
jovcuti 
jova.uti 
jovo.uti 
jovo.uti 
jovo.uti 
jovo.uti 



I.Dote; 
I.GregorionCalendor; 
I.Hoshtoble; 
I.SimpleTimeZone; 
I.StringTokenizer; 
[.TimeZone; 
I.Vector; 



The <code>SeriolizerlF</code> thot is used as the bose level 
seriolizer. it contoins three tobies used to serialize objects: 
<br><ul> 

<li> codeToble: the toble containing the seriolizotion code of 

on object bosed on the name of the closs 
<li> nomeToble: the table contoining the name of the closs 

bosed on the seriolizotion code 
<li> seriolizotionToble: the table containing the seriolizer of 
on object bosed on its seriolizotion code 

</ul> 
<br><br> 

<code>BoseSerializer</code> delegotes the responsibility of 
serializing the objects to the <code>SerializerIF</code> ossocioted 
with that class or to the object itself if it implements 
<code>Externalizoble</code>. 

public closs BoseSeriolizer implements SeriolizerlF | 
static private finol int NULL.OBJECT = 0; 
static private finol int OTHER = OxOOff; 

static private finol String HASHTABLE_SER = "ClossNomeHosh.ser"; 
static privote finol String INLFILE = "ClassNames.ini"; 

static private Hoshtoble codeToble = null; 

static private Hoshtoble nomeToble = null; 

static private Hoshtoble seriolizerToble = null; 

stotic private BoseSeriolizer instonce = null; 

class BigDecimolSeriolizer implements Seriolizer IF j 

public Object readObject(Objectlnput in) throws ClassNotFoundException, lOException | 
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int scole = in.readShortQ; 
int size = in.readShort(); 
byte[] bytes = new byte[size]; 
in.reodFully(bytes); 

Biglnteger temp = new Biglnleger(bytes); 
iclufH wt-H BiyDeuIifiQiXtennp, scaiey; 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
BigDecimol bigO = (BigDecimol)element; 

int scole = biqD.scoleQ; 
bigD.setScole(0}; 



doss BiglntegerSeriolizer implements SeriolizerlF | 

public Object readObject{Objectlnput in) throws ClossNotFoundException, lOException 

int size = in.readShort(); 
byte[] bytes = new byte[size]; 
in.readFully(bytes); 

return new Biglnteger(bytes); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
byte[] bytes = ((Biglnteger)element).toByleArrGy{); 

out.writeShort(bytes.length); 
out.write{bytes); 

doss BooleonSeriolizer implements SeriolizerlF | 

public Object reodObject(Objectlnput in) throws ClossNotFoundException, lOException 

int volue = in.reodByteQ; 

return (volue == 1) ? Booleon.TRUE: BooleonJALSE; 

public void writeObject(ObjectOutput out. Object element) throws lOException j 
out.writeByte(((Boolean)element).booleQnValue() ? 1 : 0); 




out.writeShortfscale); 

out.writeShort(bytes.length); 

out.write(bytes); 
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ByleSericliz^r implements SerializerIF { - 

public Object r8ad0bject(0biectlnput in) throws ClassNotFoundException. lOException j 
byte value = in.reodByteQ; 

^ return new Byte(vGlue); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
^ out.writeByte(((Byte)element).byteValue()); 

class CharocterSerializer implements SerializerIF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException j 
char value = in.readChar(); 

^ return new Character(vQlue); 

public void writeObject(ObjectOutput out, Object element) throws lOException { 
out.writeChar(((Character)element).charValue()); 

I ^ 

doss DoteSeriolizer implements SerializerIF | 

public Object read0bject(0bjectlnput in) throws ClossNotFoundException lOException \ 
long value = in.reodLongQ; 

^ return new Date(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
^ out.writeLong(((Date)element).getTime()); 

class OoubleSeriolizer implements SerializerIF | 

public Object reodObject{Objectlnput in) throws ClossNotFoundException. lOException | 
double value = in.readDouble(); 

^ return new Double(value); 

public void writeObject(ObjectOutput out. Object element) throws lOException | 
^ out.writeOouble(((Double)element).doubleValue()); 

^ FIG. 11 OC 
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class FloalSerializer implements SeriolizerlF | _ . , 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException \ 
float volue = in.readrioatQ; 

return new Fioat(value); 

public void writeObjecl(ObjectOutput out. Object element) throws lOException \ 
out.writeFloat(((Float)element).floatValue()); 

class GregorianColendarSeriolizer implements SeriolizerlF | 

public Object reodObject(Objectlnput in) throws ClossNotFoundException. lOException \ 
long time = in.readLongQ; 
Date date = new Date(time); 
SeriolizerlF seriolizer = BoseSeriolizer.getlnstonceQ; 
TimeZone tz = (TimeZone)serializer.readObject(in); 

GregorionCalender gColender = new GregorianCalendar(tz); 
gCalendar.setTime(date); 

return gCalendar; 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
GregorianCalendar temp = (GregorianColendar)element; 

Dote dote = temp.getTime(); 
TimeZone tz = temp.getTimeZoneQ; 

out.writeLong(date.getTimeO); 
SeriolizerlF seriolizer = BaseSeriolizer.getlnstonceQ; 
serializer.writeObject(out, tz); 

^ I 

doss IntegerSeriolizer implements SeriolizerlF j 

public Object readObjecl{Objectlnput in) throws ClossNotFoundException. lOException } 
int value = in.readlnt(); 

return new Integer(value); 

public void writeObject(ObjectOutput out, Object element) throws lOException } 
out.writelnt({(lnteger)element).intVQlue()); 

^ I 

class LonqSeriolizer implements SeriolizerlF j 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException \ 
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long value = in.readLongO; 
return new Long(vQlue); 

public void writeObject(ObjectOutput out, Object elennent) throws lOExceotion j 
^ out.writeLong(((Long)elennent).longValue()); 

doss ObjectArroySeriolizer innpiennents SeriolizerlF | 

public Object reQdObject(ObjectInput in) throws ClossNotFoundException, lOException | 
int size = in,readShort(); 

Object[] array = new Object[size]; 
for (int i = 0; i < size; i++) } 

SeriolizerlF seriolizer = BaseSerializer.getlnstonce(); 

arroy[i] = serializer.readObject(in); 

return orray; 

I 

public void writeObject(ObjectOutput out. Object elennent) throws lOException \ 
Object[] arroy = (Object[])elennent; 

out.writeShort(array.length); 

for (int i = 0; i < array length, i++) | 

SeriolizerlF seriolizer = BoseSerializer.getlnstance(); 

seriolizer.writeObject(out, orray[i]; 



class ObjectSeriolizer innplements SeriolizerlF | 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException | 
^ return in.readObject(); 

public void writeObject(ObjectOutput out, Object element) throws lOException | 
out.writeObject(elennent); 

I ^ 

doss ShortSeriolizer implennents SeriolizerlF } 

public Object reodObject(Objectlnput in) throws ClossNotFoundException. lOException | 
short value = in.readShort(); 

^ return new Short(volue); 
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public void wrileObject(ObjeclOutput out, Object element) throws lOException j 
out.vyriteShort(((Short)element).shortVolue()); 

^ \ 

doss SimpleTImeZoneSerializer implements SeriolizerIF | ^ 

public Object reQdObject(ObjectInput in) throws ClassNotFoundException. lOException j 
int offset = in.readlntQ; 

SeriolizerIF sericlizer = BaseSeriolizer.getlnstance(); 
String id = (String)serializer.readObject(in); 

return new SimpleTimeZone(offset, id); 

public void writeObject(ObjectOutput out, Object element) throws lOException \ 
SimpleTimeZone temp = (SimpleTimeZone)element; 

out.writelnl(temp.getRowOffsetO); 

SeriolizerIF seriolizer = BoseSeriQlizer.getlnstanceQ; 

seriolizer.writeObject(out, temp.getlDQ); 

^ I 

doss StringSeriolizer implements SeriolizerIF | r.r v \ 

public Object readObject(Objectlnput in) throws ClossNotFoundException. lOException } 
int size = in.reodShort(); 
byte[] bytes = new byte[size]; 
in.reodFully(bytes); 

return new String(bytes); 

public void writeObjectfObjectOutput out, Object element) throws lOException j 
byte[] bytes = ((String)element).getBytes(); 

out.writeShort(bytes.length); 
out.write(bytes); 

^ I 

class VectorSeriolizer implements SeriolizerIF \ 

public Object readObject(0bjectlnput in) throws ClossNotFoundException. lOException j 
int size = in.reodShortQ; 

Vector vector = new Vector(size); 
for (int i = 0; i < size; i++) | 

SeriolizerIF seriolizer = BaseSeriolizer.getlnstance(); 

vector.addElement(seriolizer.readObject{in)); 

I 
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return vector; 

I 

puh!:c void writeOojecl(ObjectOutput out, Object element) il.rows iOException } 
Vector temp = (Vector)element; 

Object[] array = new Object[temp.size()]; 
for (int i = 0; i < array.length; j 
^ array[i] = temp.elementAt(i); 

out.writeShort(array.length); 

for (int i = 0; i < array.length; i++) | 

SerializerIF seriaiizer=BaseSerioli2er.getlnstance(); 

serializer.writeObject(out, orrayfi]); 

... ■ ' 

* Default constructor. The constructor is privote because this is a 
» singleton doss. When the object is constructed, it initializes its 

* tables. 

V 

privote BoseSeriolizerQ | 
^ initO; 

A* 

♦ Adds the given elements to the three tobies. 

» @porom clossNome the nome of the cioss 

* @paronn code the code for the given closs 

♦ ©poronn seriolizer the object responsible for seriolizinq the given 

♦ closs 

V 

private void addDataToTables{String clossNome. Number code. SerializerIF seriolizer) j 
getCodeToble().put(code. clossNome); 
getNameToble().put(clossName. code); 

if (seriolizer != null) | 

getSerializerTable().put(code. seriolizer); 

i 
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♦ Creoles the codes and seriolizer objects for the default serialization 

♦ classes and odds thenn to the tables. The tables ore then written to 

♦ 0 seriolized file. 

privote void createDefaultTobles() j 

addDctaToTables(BigDecimal.class.getName(), new Byte((byte)1), new 
BigDecimolSerializerO); 

addDatoToTobles(Biglnleger.closs.getNome(), new Byte((byte)2). new BiglntegerSerializer(jj; 

oddDataToTablesfBoolean.class.getNameQ. new Bvte((byte)3), new BooleonSerializer()); 

oddOatoToTables(Byte.closs.getName(), new Byte((byte)4), new ByteSerializer()); 

addDataToTables(CharQcter.closs.getName(). new Byte{(byte)5). new CharacterSeriolizer()); 

addDataToTablesfDate.ciass.getNameQ. new Byte((byte)6y new DateSerializer()); 

oddOatoToTableslDouble.class.getNameO. new Byte({byte)7), new DoubleSerializer()); 

addDataToTables{Float.class.getName(), new Byte((byte)8). new FloatSerializer()); 

oddDataToTables(GreqorianCaiendar.class.getName(), new Byte((byte)9). new 
GregorianColendorSerializerQ; 

oddDataToToblesjlnteger.ciass.getNameQ, new Byte((byte) 1 0). new IntegerSeriolizerQ); 

oddDataToToblesjLong.class.getNameQ, new Byte((byte)1 1), new LongSerializerQ); 

addDatoToTablesfShort.ciass.getNameO, new Byte((byte)12). new ShcrtSeriolizerQ); 

oddDatoToTables(SimpleTinneZone.class.getNanne(), new Byte((byte)13), new 
SimpleTimeZoneSeriolizerO); 

oddOataToToblesjString.cioss.getNameO, new Byte{(byte)U), new StringSerializer()); 

oddOatoToTobleslVeclor.closs.getNameO, new Bytef(byte)15j. new VectorSerializer()); 

oddDataToTables(Object.class.getName(), new Byte((byte)16). new ObjectSeriolizer()); 

writeToblesO; 

I 

A* 

♦ Returns an instonce of the table of class names, keyed by their code. 
» If the table does not exist, it is created. 

* 

♦ ©return The table of class names. 

*/ 

protected Hoshtoble getCodeTable() } 
if (codeTable == null) \ 

codeTable = new HoshtobleQ; 
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return codeToble; 

I 

/** 

♦ Returns an instance of <code>BoseSerializer</code>. 
* 

« ©return An instance of <code>BoseSeriolizer</code>. 
♦/ 

public static SerializerlF getlnstance() | 
if (instance == null) { 

instonce = new BaseSerializer(): 

I 

return instance; 

I 

♦ Returns an instance of the table af codes, keyed by their 

♦ corresponding class name, 

♦ If the table does not exist, it is created. 

» ©return The table of codes. 

protected Hoshtable getNomeTableQ | 
if (nonneTabie == null) { 

nanneTable = new HashtableQ; 

I 

return nanneTable; 

I 

A* 

♦ Returns on instance of the table of seriolizers. keyed by their 

♦ corresponding code. 

♦ If the table does not exist, it is created. 
* 

♦ @ return The table of class names. 

protected Hoshtable getSerializerTobleQ | 
if (serializerToble == null) { 

seriolizerToble = new Hashtable(); 

I 

return seriolizerToble; 

♦ Initiolizes the hoshloble from either a serialized hoshtable or from 
« an ini file. 

FIG. 1101 
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\ ■ 

protected void initQ | 

File seriailzedFile - new File(HASHTABLE_SER); 
File iniFile = new FileflNLFILE); 

if (seriolizedFile.existsO) | 

reodSerializedFile(serializedFile); 

I else I 

if (iniFile.existsQ) | 

reQdlniFile(iniFile); 

I 

createOefoultToblesO; 

I 

I 

/- 

* Gets the value of the serialization code fronn the table based on 

* the clossNanne provided. The value returned can either be a 

* <code>Byte</code> or on <code>Integer</code>. The return value 

* will be 0 <code>Byte</code> if the ciassNome is one of the base 

* data types. 
* 

* @return The serialization code of the clossNonne. 

* ©poronn classNome the nonne of the class 

private Number lookupCode(String classNome) j 
Number code = null; 

if (classNome != null) | 

code = (Number)getNameTable().get(className); 

( 

return code; 

* Looks up the hashcode in the table and returns the String value of 

* the hashcode. If the hashcode does not exist in the table 

* <code>null</code> is returned. 
* 

* ©return The object that was stored in the table with the given 
« hashcode. 

* ©parom hashcode the hashcode that will be used to look up the value 

*^ FIG. 1 1 0J 
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\ 

private String lookupName(Number code) \ 
String clossNanne = null; 

if (code != null) | 

clossName = (String)getCodeTable().get(code); 



return clossNome; 

( 

A* 

♦ Default nnethod comment. 
* 

♦ <P>PRE: 

♦ <P>POST: 

* 

» ©return Parameter not modified 

♦ ©return com.ibm.jtc.util.SeriolizerlF 

♦ ©porom code int 

*/ 

private SeriolizerlF lookupSerializer(Number code) | 
SeriolizerlF seriolizer = null; 

if (code !- null) { 

seriolizer = (SerializerlF)getSerializerTable().get(code); 



return seriolizer; 

I 

A* 

* Default method comment. 
* 

* <P>PRE: 

* <P>POST: 

« 

* ©return Parameter not modified 

* ©param iniFile javo.io.File 

V 

private void reodIniFile(File iniFile) j 
BufferedReoder in = null; 

try I 

in = new BufferedReader(new FileReader(iniFile)); 

for (String inline = in.readLine(); inline != null; inline = in.reodlineO) | 
String trimline = inLine.trim(); 
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if ((trimLine.lengthO > 0) && 

ItrimLine.stortsWithC'jjf")) \ 

StringTokenizer toker.izer - .new StrirgTokenizer(trirriLine); 

String clossName = tokenizer.nextTokenQ; 

Integer code = new lnteger(clossNonne.hQshCode()); 

SeriolizerlF serializer = null; 

if (tokenizer.hosMoreTokensQ) | 

String serializerNome = tokenizer.nextToken(); 

try I 

serializer = (SerializerlF)Closs.forNQme(seriQlizerName).newlnslQnce(); 
^ I catch(Exception e) | | 

^ QddDotaToTables(className. code, serializer); 

I catch ^Exception throwAwoy) \ 
I finally 
try I 

in.closeQ; 
I catch (Exception throwAway) \ 

I 

writeToblesO; 

A* 

* Reads the object fronn the stream by first reading the code for the 

* element then reads the appropriate data for that object. 

* ©return The object that was read from the streom. 

* ©parom in the input stream that contains the object 
*/ 

public Object readObject(Objectlnput in) 

throws ClossNotFoundException. lOException | 
Object retVol = null; 
Number code = null; 

byte boseCode = in.readByte(); 
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if (bQseCode == NULL-OBJECT) | 

retVn! = null; 
I el>e i 

. if (baseCode != OTHER) ! - 

code = new Byte(baseCode); 

( else I 

int secondCode = in.reodlntO; 
code = new Integer(secondCode); 

SericlizeriF seriolizer = lookupSerializer(code); 
if (seriolizer != null) | 

retVol = serializer.reodObject(in); 

( else I 

String clossNonne = lookupNome(code); 
try I 

retVol = Class.forNome(clossNome).newlnstance(); 

if (retVol instonceof Externolizoble) | 

((ExternalizQble)retVol).readExternol(in); 

I else I 

retVol = in.readObject(); 
I cotch(Exception e) | 

return retVol; 

I 

A* 

♦ Reods the file contoining the serialized hoshtobles of doto. 

* ©poronn seriolizedFile the file contoining the seriolized tobies 

V 

privote void reodSeriolizedFile(File seriolizedFile) | 
ObjectlnputStreom in = null; 
try I 

in = new ObjectlnputStreonn(new FilelnputStreonn(seriQlizedFile)); 
codeToble = (Hoshtable)in.readObject(); 
nonneToble = (Hoshtoble)in.reodObject(); 
seriolizerToble = (Hoshtoble)in.reodObject(); 
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catch fException throwAwoy) j 
finally | 
try I 

:n-closev); 
{ catch (Exception throwAway) j j 

if ((codeToble == null) || 

(nonneTable == null) || 
(seriolizerToble == null)) | 



j 



createDefaultTablesQ; 



* Writes the given object to the streom. First, the code representing 

* the type of the object is written, then the data within the object 

* is written. 
* 

* ©param out the output streonn that will contain the object 

* ©parann eiennent the data object that will be written 

V 

public void writeObject(0bject0utput out, Object element) 
throws lOException | 

if (element == null) | 

out.writeByte(NULL.OBJECT); 

( else i 

String clossNome = element.getClass().getName(); 
Number code = lookupCode(classNome); 

if (code != null) j 

if (code instonceof Byte) { 

out.writeByte(code.byteVolue()); 
j else if (code instonceof Integer) | 

out.writeByte(OTHER); 

out.writelnt(code.intVolue()); 

i 

SeriolizerlF seriolizer = loakupSeriali2er(code); 

if (seriolizer != null) | 

serializer.writeObject(out, element); 
I else if (element instonceof Externolizoble) | 

((Externalizable)element).writeExternal(out); 
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j else I 

out writeQb]::-:t(elen?er.t); . 

I 

I else I 

if (element instonceof Objectf]) | 

clossNome = Object[].closs.getName(); 

I else I 

clossNome = Object.class.getName(j; 

j 

code = lookupCode(clossNome); 

SeriolizerlF serioiizer = lookupSerializer(code); 

out.writeByte(code.byteValue()); 
serializer.writeObject{out. element); 



I 



* Writes the tables to the file. 
*/ 

private void writeTobles() \ 

ObjectOutputStreom out = null; 

try I 

File serFile = new File(HASHTABLE.SER); 

out = new ObjectOutputStreom(new FileOutputStreom(serFile)); 

out.writeObject(getCodeToble()); 

out.writeObjectfgelNomeTableQ); 

out.writeObject(getSerializerToble()); 

out.writeObject(new DoteQ); 
I catch(Exception e) | 
I finolly { 

try I 

outxIoseQ; 
I catch(Exception e) | j 

I 



FIG. 1100 



